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1.0 INTRQQUCTION 



The job is the vehicle through which the Individual user 
interfaces to the IPL Operating System. A job is comprised of a 
set of user defined f unct ion/e nvironment def ini tions and a set of 
formal system created structures. The definitions provided by 
the user occur in the form of system command language statements 
which describe and direct a computing process. The system 
created structures permit the operating system to uniquely 
identify* monitor, and account for the user computing session. 

Users may present job definitions to the operating system 

from either batch input devices or from interactive terminals. 

In the first case a complete sequence of command language 
statements is transferred from the input device to system mass 

storage for subsequent processing. In the second case command 

language statements are interpreted on a statement-at-a-time 
basis as they are read from the terminal. 

Job Management is concerned with the following areasi 

Recognizes that a terminal or a batch input device is ready 
for servicing; 

Establishes a basic environment within which the Job will 
operate; 

Schedules the use of computing facilities among multiple 
Jobs? 

Distributes j ob- generated output files to User specified 
destinations; 

Controls the allocation of peripheral resources to active 
jobs; 

Returns system resources from terminated jobs and; 

Accounts for the system resources used by jobs. 

The normal mode of operation of the IPL Operating System is 
to have as many jobs active in the system as an installation will 
permit. All scheduling? resource reservation* and operational 
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decisions are made by the job through command language statements 
as it executes. It is assumed that all jobs are active and 
scheduling decisions are made as a result of command language 
requests which are described elsewhere in this and the command 
language documentation. Jobs which are queued due to system 
saturation are removed from the queue and placed into execution 
on a first in first out basis. 



1.1 D£FINILiON_.OF_j:£SHS 



Command Language - the language through which 
communicates with the system. 



an external user 



Command Language Interpreter - the system provided routine which 
is responsible for recognizing aid interpreting 
statements written in command language. 

Control Language - the SWL language macros through which an 
executing program communicates with the system. 

End of Physical Inout Stream - a logical status pertinent to the 
system input stager. This status occurs only when a 
system input, device signals "end of data" and the final 
record in the input buffer is a fence record. 

Fence Record - a system defined record of a unique configuration 
which is placed at the end of a logical input stream to 
identify the end of that logical input stream. 

Job Establishment - the process of creating basic and fundamental 
structures for identifying and controlling a new job. 
Job Establishment functions are performed by the Job 
Establisher tasK in the System Job. 

Job Initiation - the process of expanding the local environment 
of a previously established Job. Job Initiation Is 
performed by the Sequence Monitor task in each individual 
Job. 

Logical Input Stream - the volume of input data which appears 
between fence records in a physical input stream. 

Physical Input Stream - all input data which is available to the 

system via an active system input device. A physical 

input stream is comprised of one or more "logical" input 
streams. 
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1.0 INTROOUCTION 
1.2 JOB SUBMISSION 



Primal Inv/ocator Identifier ,- the ultimate terminal or site which 
caused the execution of a job. The orimal invocator 
identifier (PII) of an interactive job is the terminal. 
If the interactive job SUBMITS a batch j ob» the batch 
job's PII is also the terminal. Tne PII is used to 
identify the logical operator of a job and for default 
file routing information. 

Primary Input File - the source from which an instance of the 
Sequence Moni tor obtains command language statements when 
no alternative source is specified by the command 
language. The name of the Primary Input File is 
information required by the Sequence Monitor from the 
routine which invoked it. A disK file is the primary 
input file for a batch job. The primary input file for 
an interactive job is the terminal. 

Resource^ non-preemptible - a non-preemptible resource is one 
which cannot be taken away from a job without cooperation 
from the job. Non-preemptible resources include files* 
volumes and units. 

Resource, preemptible - a preemptible resource is one which can 

be taken away from a job* used by another job» and 

returned with no effect on the first job except execution 

time. Preemptible resources include memDry and CPU's. 



Sequence Monitor - a system provided program which serves as the 
primary control element during the interpretation of a 
logical input stream. The command language interpreter 
comprises a part of the sequence monitor. 

Staging - the process of transferring logical input streams from 
system input devices to mass storage files. Each logical 
input stream is placed on a unique mass storage file. 

System Input Device - an input device which the system defines as 
being dedicated to the process of submitting "physical" 
input streams. 



System Input Stager - the system 
responsible for staging. 



provided routine which is 
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1.2 JQf 



LUBMISSiaN 



1.2.1 FROM EXTERNAL SOURCES 



Jobs may be introduced in one of two ways based on the 

classification of the initiating device. If the device is 

classified as a system input device then its function is the 
submission of batch Jobs. If it is classified as an interactive 

terminal then its function is the submission and control of 

interactive jobs. A device's mode of operation is determined by 

installation parameters and .the functional attributes and 
capabilities of the device. 



1.2.1.1 Sy stem I n out De\>ices 



When a device classed by an installation as a system input 
device becomes active the input stager is notified. This routine 
will create a temporary mass storage file as a destination for 
the job deck being entered from the device. When an end-of-file 
is detected the input stager makes the temporary mass storage 
file containing the job deck a permanent mass storage file. This 
permits the system to remember files that have been completely 
staged across a system crash. The input stager next prepares to 
submit the job to job management. 

If the submit request is rejected due to any type of system 
saturation, the job is queued for subsequent execution. 



1.2.1.2 I n t e ra c t i V e p e y jc e s 



When an interactive terminal becomes active either through a 
dial-in or initiation of activity on an inactive terminal, the 
System Access Manager is notified. The System Access Manager 
prepares to submit a job with the terminal as the primary input 
file. 

If the submit is rejected due to system activity, the user 
will be notified at his terminal to try again at a later time. 
The terminal will then be closed and disconnected i f on a dial-up 
line. 
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1.0 INTRODUCTION 
1.^ JOB TERMINATION 



1. 2.2 FROM ACTIVE JOBS 



the 

caps 
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jobs 



The capability is provided by which active jobs may invoKe 
asynchronous processing of other jobs. To utilize this 
bility the active job must provide a file of command language 
einents on a permanent mass storage file and then request the 
tion of a job which will utilize the file as its primary 
t file. Jobs created in this manner are initiated as batch 



1.3 JOB INITIATION 
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1.^ JO B TER MINATION 



Job Termination is a system-supplied facility which provides 
the functions and the control required for the systematic removal 
of previously initiated jobs from the system. The job 

termination process executes within the individual job under 
control of the cognizant instance of the Sequence Monitor 
program. The job termination orocess is invoked within a job as 
a result of one of the following situations! 

1. A command language logout statement is encountered by the 
command language interpreter in the command sequence which 
it is currently servicing, or an end-of-file condition is 
encountered by the command language interpreter while 
processing statements from the primary input file. 

2. A command language login statement is encountered subsequent 
to job initiation (i.e., a second login command) by the 
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command language interpreter in the command sequence 
currently being serviced. 

**NOTE** The logout capability is also provided via control 
language. The second login capability is not. 
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1. 
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INTRODUCTION 
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OUTPUT 


FILE DISTRIBUTION 





1.5 OUI£UX_FIl.£_aiaiSIBUIION 



Output file distribution is a system-supplied facility which 
transfers user-specified output files to user-specified 
destinations (printers? punches? terminals). 

The routing mechanism provided by Job Management is designed 
to facilitate the transfer of data between any file in the system 
and any output device. Obvious incompatibilities will occur such 
as attempts to output libraries of object code. It is intended 
that the routing facilities provide standard conversion utilities 
to reformat the data in such a way as to provide useful output. 

The three TasK Services requests which provide the user 
interface are JM^ROUTE, JM#DIRECT, and JM#RETRADT. There will 
also be a number of operator control mechanisms which permit the 
operator to achieve output unit setup and co'^trol when such 
action is needed. The latter set of directives are outside of 
the user repertoire and will be avai labl e on ly to programs which 
act at an operator's level of authority. 
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One problem which is not dealt with at the level of Task 
Services is the question of a system crash. The loss of the 
output queues should not be allowed to negate the transfer of 
these files. However, the use of a file to retain the 
information in its original form of output queues and File Router 
tables may not be practical. Other methods should be 
investigated which will preserve the information in the event of 
a system failure. It is recommended that a procedure be adopted 
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which posesses as secure a recovery mechanism as possible and 
which requires the minimum of system overhead to save the 
information necessary to restore the output queues (assuming the 
information will never or very infrequently be used). One 
possible method would be to log each route request using a unique 
identifier. When the transfer was complete, the accounting 
information would also include the unique identifier. A missing 
echo would be used to signal the recovery programs that the file 
had not been transferred. 



1.6 JOB FLOW 



1.6.1 OVERVIEW OF JOB MANAGEMENT IN SYSTEM JOB 



Following is a list of names of programs which execute under 
the auspices of the System Job and p'^ovide functions which are 
relevant to job management. For each program listed, there is a 
definition of its structure and an overview of the functions 
which it performs. 

A graphic overview of the flow of data and control among 
these listed job management programs is provided via the attached 
diagram entitled "Job Flow Through the System Job" (Figure 
1.6.1-1). Circled letters on the diagram correspond to the 
underlined letters which appear in the functional overviews of 
the programs? these letters are provided as points of reference. 
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information concerning a job for 
which establishment is desired. 
(Signal P results from the 
issuance of a JM#SUBMIT 
request from within a user job.) 
If system limits prohibit 
immediate job establishment, 
and if the job is interactive 
(or is batched with "no enqueue" 
specified)- sends a reject signal 
to the requestor. 
If system limits prohibit 
immediate job establishment, 
. but the job is batch with 
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creates a Known-Job-List (KJL) 
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established" I 
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Monitor provided 

SMf/CR£ATE_ADDRESS_5PACE request 
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Job Flow Through The System Job 
Figure 1.6.1-1 
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The controlling element of every user Job is a system 
provided program - SEQUENCE MONITOR. This program, which 
executes as a task in the address space of every user ] ob , is 
constituted of numerous procedures? these procedures are 
logically categorized into four sets of procedures? Sequence 
Monitor Main Control, Job Initiation, Command Language 
Interoreter, and Job Termination. A general discussion of the 
responsibilities/functions of each set of procedures within the 
Sequence Monitor program follows. 
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procedure (IP(1)), in response 
to the call H from TPd), 
issues calls to selected 

subsidiary procedures 13 and it 
to effect re-expansion of the 
job's environment to its usual 
I evel f ol I owing j ob 

initiation. 
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1.0 INTRODUCTION 
1.7 PROFILES 
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1.0 INTRODUCTION 
1.7 PROFILES 



1. 7 PSOFilES 



A major facet in the tuning of the operating environment for 
a particular user is profile processing. Profiles are files of 
command language statements which are accessed via a system 
profile directory. They are implicitly executed by the Command 
Language Interpreter as various levels of user identification are 
achieved. Their interpretation is analogous to that caused by 
the ENTER command languafge statement. 

When the Command Language Interpreter is first entered^ it 
executes a System Profile* if any. This can set installation 
default conditions and limits on a I I system users. 

Next, the profile appropriate to the terminal (or system 
input device) and port are processed. 

After this* the LOGIN is processed to determine the account 
and user identifiers. Profiles corresponding to these identities 
are processed in that order. 



Finally, interpretation commences on the primary input 
for the job. 



fi le 



All functions and system services whic^ are available 
through normal command language sequences are also available 
through profile orocessing? e.g.? through the use of profiles? 
standard environmental requirements such as priorities, various 
limits, mounting of removable volumes» 
attaching/detachinq/ooeninq/cl osing files, dialogue with the 
operator, etc., can be fulfilled implicitly as oart of the login 
process. 
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1.8 SAMPLE JOBS 

JOB WHJ "COBOL COMPILE AND EXECUTE" 
COLLECT SOURCE 

. COBOL SOURCE DECK APPEARS HERE 



COBOL I=SOURCE, = OdJECT, L = LI5TING, S=ERR 
IF ERR. LEVEL GT 

PRINT LISTING 

JOBEND 

IFEND 
SAVE OBJECT 
OBJECT A00=03JECT 
COLLECT DATA UNTIL = /. 

. DATA DECK APPEARS HERE 



EXECUTE PR0G=MAIN, PARAM=DATA 
JOBEND 

JOrj WHJ "COBOL EXECUTE ONLY" 
OBJECT AOO=OBJECT 
COLLECT DATA UNTIL = /. 

. DATA DECK APPEARS HERE 



EXECUTE PRnG=MAIN, PARAM=DATA 
JOBEND 
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2.0 ACCOUNTING 
2.2. 3 RECORDING 



2.0 A££J3UNIIN|G 



2.1 fiaaEQILV£S_OF_lPL_AmiQUblIIllG 



o Detectt measurej and record utilization of system 
resources by users of the system. 

o Provide consistent information regarding resource 

utilization for every identical running of a given job. 



2. 2 D£IECIinNi_J^£MySO£NIj._fiE£OBOIJs|a_^F_R£iOUB£^_UIILIZAIIOfci 



2.2.1 DETECTION 



Detection of an instance of resource utilization is the 
responsibility of the system procedure which is chartered to 
manage the resource? for example* File Manager is responsible for 
the detection of file creations* releases* etc. while Buffer 
Manager may be responsible for the detection of file activity. 



2.2.2 MEASUREMENT 



Measurement of resource utilization consists of providing 
detail information relevant to the use of each resource? some 
information may be common to all resources while other 
information may be peculiar to only one resource. (The 

discussions of the text portions of accounting records are 
included in the section on System Logging.) Measurement* also, 
is the resDonsibi I i ty of the system procedure which manages a 
resource. 
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2.2.3 RECORDING 



Information regarding each use of a system resource is 
recorded on a SYSTEM LOG FILE by the appropriate manager of a 
resource at the time the usage is quantifiable. Recording of 
accounting information on a SYSTEM LOG FILE is accomplished 
through use of the JM//SYSLOG request provided by Job Management* 
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3.0 SYSTEM LOGGING 
3,2. 1 RECORD HEADER 



3.0 



Logging of system accounting, system error » and system 
dayfile information is accomplished by system elements through 
use of the JM/ASYSLOG reauest. The request processor which 
services the JM/ZSYSLOp request appends requestoi — specified log 
information to a standard record header and transmits that set of 
information to a system-provided System Log File. 



3.1 i01i.FXLL.£HARA£I£BISII£S 



Any system-provided file which is to be utilized as the 
System Log File must possess the following characteristics! 

o the file must reside on disK storage? 

o the file must be permanently cataloged and the system 
defined to be its owner; 

o the file must be sequentially organized? 

o the file's blocK size must be of fixed length and equal to 
^096 bytes; and 

o the file must be dynamically expandable by block-size 
increments. 



3.2 LOG F3 



lgO_£iJAEA£I 



System Log File records are of variable lengths. Each 

record is comprised of a standard, fixed length Log File record 

header and a variable length record text portion which is 
peculiar to the type of record. 
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3.2.1 RECORD HEADER 

The standard Log File record header contains the information 
listed below. 

Record Identifier Code 

A hexadecimal number of the form ttccss, where tt identities a 
record type, cc identifies a class of record within a typet 
and ss identifies a record subc lass wi thin a class. 

The following values for ii are currently defined. 

tt=01 System Bench Mark Record 

tt=02 Job Bench Mark Record 

tt=0 3 Accounting Record 

tt=0^ Error Record 

tt=05 Dayf i le Record 

Specific values of cc and ss are defined in individual 
discussions of the various record types. 

Current Time 

o Length of the record text portion. 

3.2.2 RECORD TEXT 



3.2.2.1 System B ench Hark Records (I dentifier Code=0 1ccss> . 



o Current Date 

o Central Site Identifier 

o Software version/maintenance level 
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3.0 SYSTEM LOGGING 

3.2.2.2 Job Bench MarK Records (Identifier Code=02ccss) 



3.2.2.2 J ob_9^nch_Mark Re cords (Id en tifier Cod e=Q2cps^) 

3- 2. 2. 2.1 JOB B£ N£H_MA_RK. I 

o Internal Job Identifier (a concatenation of the KJL entry 

ordinal and the KJL entry sequence number) 
o External Job Identifier (system assigned JOB name) 
o Account Identifier 
o User Identifier 

3.2.2.2.2 JOS BENCH MAR K II 

o Internal Job Identifier 

3.2.2.3 A c c ou nil na_^ CO r ds Lldentifier code = 03ccss )_ 



3.2.2. 



3.2,2, 
o 
o 

3.2.2, 
o 



3.2.2. 
o 



3.1 VOLUM£_SET RESERVATION RECORD 
Internal Job Identifier 

Volume set name 

3.2 VOLUM£_SEI_EEi;£AS£_gEnOED 
Internal Job Identifier 
Volume set name 

3.3 UNII_SET RESERVATION REC ORD 
Internal Job Identifier 
Peripheral type 

Number of units 
3.^ UNII_S£I RELEASE RECORD 
Internal Job Identifier 
Peripheral type 
Number of units 
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3.0 SYSTEM LOGGING 

3.2.2.3.5 FILE CREATION RECORD 



3.2.2.3.5 £ IL£^C R£ A I I ON^gEaOEO 
o Internal Job Identifier 
o Fi le name 

o Volume set name on which the file resides 

o Type of peripheral to which the file is assigned 

o Number of bytes of storage allocated to the fife 

3.2.2.3.6 FILE EXPAN^XO.H. RECORD 
o Internal Job Identifier 

o File name 

o Account name» User name; if the named file is temporaryf 
these names will be identical to those in the Job Bench 
Mark I record associated with the Job requesting the file 
EXPAND operation? if the fiie is cataloged as permanent^ 
these names will be those registered in the 

cata I og 're gardless of whether the file i^ tem porary or 

permanent t the . a-C^o.gn.t.n.ame.. and user name specifi e d her^ 

are the on es t o which accou nti ng a pplie s 

o Volume set name on which the file resides 

o Type of peripheral to which the file is assigned 

o Previous file size? this is the number of bytes of storage 
allocated to this file prior to this operation 

o New file size? this is the number of bytes of storage 
which is allocated to the file subsequent to this 
operation 

o Date and time of most recent prior adjustment to the size 
of the file (i.e.» creation or expansion)* for permanent 
files this information may be obtainable from the file's 
catalog; for temporary files this information must be 
maintained within a file related table and recorded in a 
catalog if the temporary file is ultimately made 
permament. 
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3.0 SYSTEM LOGGING 

3.2.2.3.7 FILE RELEASE RECORD 
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3.0 SYSTEM LOGGING 

3.2.2.3.9 JOB TERMINATION RECORD 



3.2.2.3.7 F.IL E^R£L£AS £^REQ RQ 

The text area of the. File Release record is identical to 
that of. the File Expansion record 

3.2.2.3.8 FIi^_ ACTIVITY RECORD 
o Internal Job Identifier 
o Fi I e name 

o Volume set name 

o Type of peripheral to which the file is assigned 

o Date and time file was opened 

o Date and time file was closed 

o Number of read operations 

o Number of write operations 

o Total number of bytes transferred to and from the file 

3.2.2.3.9 J OB_I£RMINA 11 ON ...R £ C OEfl 
o Internal Job Identifier 

o Date and time of job initiation 

o Date and time of job termination 

o Job mode? initial or restart execution tfor future 
considerat ion) 

o Job class* batch, interactive 

o Termination type? normal* abnormal 

o Number of System Command Language statements processed 

o Primary invocator identifier 

o CPU time used; total number of milliseconds of real time 
during which control points of the job were dispatched 

o Memory used? an accumulated page- time value 

NCR/CDC PRIVATE REV 27 MAY 75 
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3.2.2.3.10 FILE R OUTT NG RECORD 

o Internal Job Identifier 

o Fi le name 

o Date and time routing initiated 

o Date and time routing completed 

Peripheral type of source device 

o Peripheral type of destination device 

o Destination name 

o Special forms identifer 

o Number of copies routed 

Number of read operations 

o Number of write operations 

o Total number bytes transferred 

3. 2, 2. ^ Error R ecor ds ( Ident it ier _qpde=p^ccss) 

To Be SuppI ied 
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3.0 SYSTEM LOGGING 

3.2,2.5 Dayfile Records (Identifier code=05ccss) 
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3.2.2.5 Day t i le Records (I dent if ie r c ode = 05c ess) 

3.2.2.5.1 MESSAGE TO OPERATOR ' 

o Internal Job Identifier (from which message is issued) 

Operator Identifier 

o Text of message transmitted to the operator 

3.2.2.5.2 ME SSAGE_FROM_OPE RAISE 

o Internal Job Identifier (for which message is intended) 

o Operator Identifier 

Text of message from operator 

3.2.2.5.3 F R£F -FO iM_M FS SA G ES 

o Text of any free-form message which any system element 
desires to be placed on the System Log File; if sender 
identifier is necessary it is the responsibility of the 
sender to include such information within the message 
text. 

3.3 ASSIGNED RECO RD IDENTIFIER CODES 
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Job Bench MarK I 
Job Bench Mark II 

Accounting Records 
Volume Set Reservation 
Volume Set Release 
Unit Sef Reservation 
Unit Set Rel ease 
File Creation 
File Expansion 
File Rel ease 
Fi le Activity 
Job Termination 
File Routing 

Error Records 

Day file Records 
Message to Operator 
Message from Operator 
Free-form Message 
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^.0 SCHEDULING 
k,2 JOB SCHEDULING 



^.0 SCHEDULING 



^•1 DEVICE A LLOCATION AND SCHEDULING 
To Be SupDl led 
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4- 2 iiOB_SCH£J2ULlNG 



The normal mode of operation of the IPL Operating System is 
for ail jobs known to the system to be in some sense active. 
User validation and command language interpretation are not done 
until a Job has been established and has executed for some period 
of time. Thus, very little is Known about a job before it is 
executing. Job scheduling is designed to accomodate this mode of 
operation, where jobs must be preempted as they express 
requirements for resources and resumed as the resources become 
avai I able • 

Job scheduling is designed to be, as much as is feasiblet 
table driven. Many of the factors which determine scheduling 
decisions may be set at system generation time and/or varied 
dynamically while the system is running. This will permit an 
installation to tune scheduling to its particular mode of 
operation and to change the mode of operation during the 
processing day. 

Job scheduling must accomodate a mixture of batcht 
interactive, and transaction jobs simultaneously and in various 
combinations. 



4.3 ^QB^IAIES 



A job in the IPL Operating System exists in one of several 
states which are of interest to the schedulers. These states 
arei queued, deferred, inactive, and active. There will also be 
frequent references to the running state which implies inactive 
or active. These states correspond to the amount known about a 
job and the amount of system resources used by a job. The system 
knows the least about a queued job and it uses the least system 
resources. The system knows the most about an active job and it 
requires the most system resources. 

One of the major functions of job scheduling is to move Jobs 
from one state to another. The following diagram indicates which 
state transitions are possible and also which scheduler controls 
that transition. 
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4.3 JOB STATES 



RESOURCE 



STATE 
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1 






E \ 




QUEUED 




none 




* 


\ 


none 




I 

none 1 




DEFERRED 




swap 
f il e 




swap 
f i le 


1 
1 


swap 
file 


1 f 
laM ocatedl 


f- 


INACTIVE 


- + - 


swap 
file 


-4- 


in 1 

memory? 
+ 


in 

memor 


/lat 1 


1 

ocatedl 
.+ 



I 



I 

I ACTIVE 



Ion I I 

I J Idis- I I 

I in I in Ipatch I I 

I memory I memory Icha in lal I ocatedl 



* Known Job List Entry and Job Control Block allocated. 



4 . 4 SCHEDULER TABLES 



As mentioned earlier* the schedulers are taole driven. This 
section describes the various tables used by the schedulers to 
determine their decision making process. The method of supplying 
these tables initially is yet to be determined. Requests are 
provided to modify the tables while the system is running. 



4.4.1 CLASS ATTRIBUTE TABLE 



The Class Attribute Table (CAT) defines the attributes and 
characteristics of each class of jobs. There can be any number 
of classes (installation defined) but there must be at least 
three! System* Initial Batch, and Initial Interactive. These are 
the classes that the system Job is in and batch and interactive 
Jobs are in respectively when they are first established. 
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CLASS ATTRIBUTE TABLE 



ATTRIBUTE 



I CPL N on- preempt 

I CPL Deferred 

•• CPL Running 

I Maxi?num Priority 

\ Maximum Known Jobs 

J Maximum Running Jobs 

\ Maximum Active Jobs 

5 Maximum Total Working Set 

5 Major Time Slice 

S M inor Time S I ice 

t Dispatch Time SI ice 

I PFF Goal 

J Lowest Scheduling Level 

I Non-preempt Priority 

t Increment 

I Deferred Priority Increment 

I Inactive Priority Increment 

I Active Wait Time 

I Inactive Wait Time 

I Maximum Wait Time 

J Class Residence Time 

I Next Class (Time) 

I Maximum Job Working Set 

I Next Class (WS) 

4- 



SYSTEM 



INITIAL 
BATCH 



INITIAL 
INTER- 
ACTIVE 



INSTALLATION 
DEFINED 



CPL Non-preempt I 
CPL Deferred! 
CPL Running! 



CPL = Class Priority Level 
These fields define the priority 

relationship among classes tor 
different phases of scheduling. 
There may be as many levels as 
classes but there can be fewer; 
e*g*f several classes may have the 
same CPL for non- preempt ib I e 
resources. 

CPL is an integer a..n with having 
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Maximum Priority! 



Maximum Known Jobs! 
Maximum Running Jobs! 
Maximum Active Jobs! 



Maximum Working Set! 



Major Time Slice! 
Minor Time Slice! 
Dispatch Time SI ice! 



PFF Goal ! 



Lowest Scheduling Level! 



the most priority and n the least* 
This is so that classes may be added 
with little impact on previously 
defined classes* 

The highest base priority that a job 
in this class can have* 

The maximum number of jobs of this 
class which can be simultaneously 

known to the system or In the 
Running and Active states* 

respectively* 

Maximum real memory simultaneously 
available to all jobs in this 
c lass • 

The time slices to be allocated jobs 
in this class when they go 
to the Running State* Active State* 
or one of their control points is 
dispatched on a processort 

respectively * 

Page Faul t Frequeicy goal for jobs 
in this class* The schedulers will 
adjust running parameters to 

normalize a job's fault frequency to 
this value* 

Limits jobs in this class to the 
Def err ed_Runn in g^Active, 
Running_Acti ve* o?* Active only 
states* 



Deferred Priority Increment! The amount to increment a job's 
Inactive Priority Increment ! effective priority based on time job 
Non-preempt Priority has been in the Deterred or Inactive 

Increment! states respectively or requires 

non-preemptible resources* 



Active Wait Time! 
Inactive Wait Time! 



The length of time that all control 

points of a job must be waiting 
before it should be moved from the 
Active to Inactive or Inactive to 
Deferred states respectively* 
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^•0 SCHEDULING 

^.^.2 CLASS PRIORITY LEVEL TABLE 



Maximum Wait Time: 



Class Residence Time: 



Next Class (Time): 



Maximum Job Working Set: 



Next Class (WS) : 



The maximum amount of time jobs of 
this class can wait before it is 
considered an error state. 

Amount of CPU time a job can stay in 

this class before it is 

automatically switched to another 
class. 

The class to which to switch the job 
if its Class Residence Time has 
expired • 

The maximum working set a job can 
have before it is. automatically 
switched to another class. 

The class to which to switch the Job 
if its maximum jobs working set 
limits has ben reached. 
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^.4.2 CLASS PRIORITY LEVEL TABLE 



The Class Priority Level Table (CPLT) defines the decisions 
and algorithms used by the various schedulers to perform the 
state transitions described in Section ^.3. There is an entry 
for each CPL used in the CAT. There are parameters in each entry 
about each state transition plus parameters controlling the 
method of allocation of non-preemptible resources. 



CLASS PRIORITY LEVEL TABLE (CPLT) 



I Class Priority Level 



- + + + + + 

I i 1 I ... I M I 



Deferred to Inactive Transition 

Method 

Priority Cutoff 

Terminat i on 
Inactive to Deferred Transition 
Inactive to Active Transition 

Method 

Priority Cutoff 

Termination 
Active to Inactive Transition 

Method 

Non-preement Resource Allocation 
Method 

Priority Cutoff 
Termination 
Partia I All ocation 



Class Priority Level: 



Deferred to Inactive State 
Transit ions: 



The pertinent class priority 
level (CPL) of the entry. The 
number of priority levels is 
smaller than or equal to the 
number of classes. 

The parameters in this section 
direct the Deferred Job Monitor 
when it selects a deferred job 
to make running. 
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if.O SCHEDULING 

i*.k.2 CLASS PRIORITY LEVEL TABLE 



Method? Round-Robin 



Method; FIFO 



Method; Priorliy 



Priority CutoffJ 



TerTTi inationJ 



Inactive to Deferred Transitioni 



Inactive to Active State 
Tr ansi t ionsJ 



Method* Round-Robin 



Jobs are examined on a circular 
basis. If a job cannot be made 
running for some reason* the 
next Job in the CPL is examined 
until all jobs in the CPL have 
been e xami ned . 

Jobs are made running in the 

order they appeared in the 

deferred state. If a job 

cannot be made running* no 

other jobs in the CPL are 
examined. 

Jobs are examined in effective 
priority order. If a job 

cannot be made running for some 
reason, the next lower 

effective priority job is 
examined until all jobs in the 
CPL have oeen examined. 

If the Method; Priority was 
selected, then jobs with an 
effective priority higher than 
the priority cutoff value will 
be treated as if Method; FIFO 
were selected. 

Determines whether or not to 
examine jobs in the next lower 
CPL if there are remaining 
deferred jobs in this CPL. 

There are no parameters for 
this transition. Jobs move 
from inactive to deferred based 
on Inactive Wait Time and Major 
Time Slice from the CAT. 

The parameters in this section 
direct the Running Job, Monitor 
whan it selects an inactive job 
to make active. 



See Deferred 
Transit ion 



to 



Inactive 
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Method; FIFO 
Method; Priority 
Pri ority Cutoff : 
Termination: 
Active to Inactive Transition! 



Priori t.y! 



Least Time S I iceJ 



System FltJ 



Nonet 



Non-preemptible Resource 
A I I ocat ionJ 



Method* Round-Robin 
Method; FIFO 



See Deferred 
Transi t ion 

See Deferred 
Transi t Ion 

See Deferred 
Transi t ion 

See Deferred 
Transi t ion 



to Inactive 



to 



Inactive 



to 



to Inactive 
Inactive 



Normally jobs move from active 
to inactive based on Minor Time 
Slice and Active Wait Time. In 
some circumstances, however, It 
is necessary for the scheduler 
to deactivate a job for other 
reasons; e.g.» system 

thrashing. This parameter 

specifies the method used to 
select a job to deactivate. 

Deactivate the job of lowest 
priority in this CPL. 

Deactivate the job which has 
the least remaining Minor Time 
SI ice. 

Deactivate the job which will 
do most to alleviate the 
situation which requires a Job 
to be deactivated • 

Do not forcibly deactivate Jobs 
in this CPL. 

The parameters in this section 
direct the Resource Scheduler 
when it selects a Job to which 
to allocate non-preemptible 
resources. 



See Deferred 
Transit ion 



to 



Inactive 
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^•0 SCHEDULING 

^•^.3 CLASS TRANSITION TABLE 



Method? Priority 
Priority Cutoff 
Terminat i on 
Partial Allocation 



Transition 

See Deferred to Inactive 
Transition 

See Deferred to Inactive 
Transi t ion 



See Deferred to 
Transi t ion 



Inactive 



Indicates whether or not some 
of a jobs non-Dreempt ib le 
resource requests should be 
satisfied if all of them cannot 
be. 
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4.4.3 CLASS TRANSITION TABLE 



The Class Transition Table (CTT) soecifies which class 
changes are valid when requested by the JM//SET_CLASS request. 



CLASS TRANSITION TABLE (CTT) 



DESTINATION CLASS 



+ + + -. + --+ .+ 

IS J I B I I I J I I 

J Y I N. A I N N I I 1 

IS I I T J I T I I I 

I T, } T C I T E { . . • I N I 

1 E I I H J I R J J I 

I M J A I A A I I 1 

I I L J L C } I I 

\ I I T I I I 

i I ill I S 

ORIGINAL I I I V I I I 

CLASS I J J E J J I 

+ I } J J , , 

JSYSTEM JY lY lY lY JYI 
f + '^^ + + ---+ f 

I INITIAL I 1 I I J J 

I BATCH IN { Y IN J * I ♦ } 

+ + •». f + . — «. + 

J INITIAL J 11 I t I 

I INTERACTIVE IN I N J Y I * I ♦ I 
f + + + — + + + 

I .1 ! ! i I I 

I . i I 1 I i i 

I . 1 N I ♦ I » I ♦ 1 ♦ I 

«■ + + + + ¥ * 

I 11 11 { \ 

I N INI»I*J»IYI 



* InstaM at ion Speci f ied 
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^.0 SCHEDULING 

^►•^.^ SCHEDULER CONTROL TABLE (SCT) 



^•if^if SCHEDULER CONTROL TABLE (SCT) 



The Scheduler Control Table contains some aarameters which 
define the general operating characteristics of the various 

schedulers* 



Frequency of Queued Job Monitor! 
Frequency of Deferred Job Monitor: 
Frequency of Running Job Monitor: 



PFF Floor: 
PFF Ceiling: 



I/O Rate Floor: 
I/O Rate Ceiling: 



Number of Classes: 



Highest CPL: 



The frequency of activation 
of these schedulers* It is 
assumed that the QJM should 
be at least an order of 
magnitude less frequent than 
the DJM, which should be ^t 
least an order ^f^ magnitude 
less frequent than^the RJM* 



The schedulers will attempt to 

maintain the total page fault 
frequency in the system somewhere in 
the range PFF Floor < System PFF < 
PFF Ceiling. 

The schedulers will attempt to 
maintain the total frequency of I/O 
requests in the system in the range 
I/O Rate Floor < System I/O Rate < 
I/O Rate Ceiling. 

The number of classes specified in 
the CAT and CTT . 



The highest CPL specified in 
entry. 



CAT 
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5,0 ENVIRONMENT OF STANDARD JOBS 
5.,2 FILES 



5.0 £NVi5i3i4i1Ei^i_OF_SIMMgQ-aQfiS 



Certain facilities/properties are provided by the system as 
constituents of all standard jobs; those constituents of which 
the user should be cognizant are are discussed in this section. 



5. 1 ADDRESS SPACE 



Segment 5.1 The System Global Logical Name Space (SGLNS) segment; 

this global segment is interpretively readable by the user. 

Segment .6: The User Local Logical Name Space (ULLNS) segment for 
the job? the segment is directly and interpretively readable 
and writable by the user. 

Seamenl_7l The System Local Logical Name Space CSLLNS) segment 
for the job; the segment is interpretively readable and 
writable by the user, 

S-e^ment^Sl The User G loba I Log ica I Name Space (U6LNS) segment? 
this global segment is interpretively readable and writable 
by the user. 



5.2 Ellgg 



JOB/MNPUli The logical name unconditionally assigned to the Job's 
Primary Input File? this file is for the exclusive use of 
Command Language Interpreter and serves as the default source 
of command language statements in the Job. 

JOB //DAYFILE: The logical name assigned to a sequentially 
organized! disK resident file which is used to record 
sequential history of activities in the Job (e.g.t images of 
command language statements processed* messages to/from 
operators* user supplied information). This file may be 
written by system elements in a Job as well as by the user 
via record level I/O functions. This file is routed 
according to the Job's Primal Invocator Identifier (PII) by 



1 
2 
3 

5 
6 
7 
8 
9 
10 
11 
12 
13 
It* 
15 
16 
17 
18 
19 
20 
21 
22 
23 
Zk 
25 
26 
27 
28 
29 
30 
31 
32 
33 
3^ 
35 
36 
37 
38 
39 
^0 
kl 
kZ 

k5 
k7 



Job Terminator 
speci f ication. 



in the absence of any user specified DIRECT 



J OB^^P RINT The logical name assigned to a sequentially organized 
disk resident file which is unconditionally provided by the 
system. This file is provided as a default file to be used* 
via record level I/O, by elements of the system and the 
product set (e.g. » loader maps* compiler source listing). In 
the absence of any user speci tied DIRECT specification, this 
file is routed by Job Terminator according to the Job's PII« 

J QB // OUT PU T? The logical name of a file which is used by Command 
Language Interpreter for communications directed to the user 
(e.g.* command language functional* syntactical or parameter 
error notification). In a batch Job JOB^OUTPUT is an alias 
logical name for JOB//DAYFILE, i.e.» Oommand Language 
Interpreter error notifications transmitted to JOB#CHJTPUT 
actually are recorded on the physical file associated with 
JOB//DAYFILE. For an interactive Job JOB^OUTPUT is the 
logical name of the output side (e.g.* display) of the 
interactive device and* consequently* Command Language 
Interpreter error notifications are transmitted to the 
interactive user; such messages are also transmitted to 
JOB//DAYFILE by Command Language Interpreter. JOB^OUTPUT is 
written using record level I/O functions. 



5.3 QlhgR 



JOBtfJCBi An LNS alias through which the user, and system elements 
within the Job address space* may reference the Job Control 
BlocK of the Job. JOBffJCB resides in the Job's SLLNS 

segment. 
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6.0 JOB MANAGEMENT REQU ESTS 



6. 1 RE QUES T PURPOSE A NOJ PARA MFT^R ...QESCRIPTION 



The foHowing requests are available for communication with 
the various Job Management facilities. 



6.1.1 JMV/SUBMIT 



The JM//SUBMIT request is utJized to request the creation of 
an asynchronously executing job in a new address space. 



JM/^SUBMIT (fname? jname^ eot do» status) 

fname : The name of a File Control Block w.Tich resides in a 
logical name space (LNS ) » and which describes the file to 
be used as the Primary Input File for the Job being 
invoked* specification of this parameter is mandatory. 
The file must be permanent? and an ACL defined for it to 
permit access under the account and user identifiers under 
which the new job will run. 

jname : Specification of this parameter is op t lona I in user 
jobs? if specified, it is interpreted to be the name of an 
alias variable which the ^system will declare in the user 
job's System Local Logical Name Space (SLLNS); the user 
may reference fields in the Job Control Block of the ] ob 
being invoked by referring to the name of the SLLNS alias 
variable. 

Specification of this parameter by the system programs 
Stager and System Access Manager is m andato ry * in these 
instancesj the parameter is interpreted to be the name of 
aJob Control Block previously declared in System Global 
Logical Name Space (SGLNS). 
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establishment is permissible. One of the following values 
for eo may be specified* 

Q I Delayed establishment is permissible 

nul I I same as Q 

I J Reject if immediate establishment is not possible 

do t This parameter value is used to specify the desired 
disposition of the Primary Input Fila following the 
running of the job being invoked. One of the following 
values may be specified for do: 

P ? Purge the file when job terminates 
K : Do not purge the fiJe 
nul I : same as K 

The P option will be honored only when the user identifier 
of the terminating Job matches the owner identifier of the 
permanent file. 

status: returned request status. 



6.1.2 J M// DIRECT 



The JM^DIRECT request permits the specification of explicit 
parameters for use with a file during the subsequent issuance of 
a JM#ROUTE request with some or all of the parameters omitted. 
Any optional parameters supplied during a JM<?ROUTE request will 
override the corresponding explicit parameters from a JM#OIRECT 
request. 



JM//OIRECT (file, destination, form, copies, status) 

file: The logical name of the file (temporary of permanent) 
to be directed. 

destination: An optional parameter whici specifies the 
logical destination name of the location to which to 
direct the file. If not specified, the default 

destination from the JM#ROUT£ request is used. 

form: An optional parameter which specifies the physical 
properties of the output medium (e.g., paper size, card 
type, printer train, ribbon color) upon which the data is 
to be placed. If not specified, the default form from the 
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JM//ROUTE request is used. 

copies: An optional parameter which specifies the number of 
copies to be placed on the output unit* If not specified* 
the default number from the JM#ROUTE request is used. 

status! returned request status. 



6.1.3 JM//RETRACT 



The JM^RETRACT request is used to cancel a previously issued 
JM/^OIRECT request on the same file. The entry that was placed in 
the local directed file list for the specified file is removed. 



JM#RETRACT (file, status) 

file! The file to be retracted. 

status: returned request status. 

6.1.^ JM^/ROUTE 



The purpose of the JM/^ROUTE request is to initiate the 
transmittal of a file (temporary or permanent) to some 
destination. If no explicit value is given for an optional 
parameter, the explicit values from a previously issued JM/^OIRECT 
request on that logical file name will taKe precedence over the 
defual t values in effect at the time the JM//ROUTE request is 
issued • 



JM#ROUT£ (file, destination, form, copies, status) 

file: The logical name of the file (temporary or permanent) 
to be transmitted. 

destination: An optional parameter which specifies the 
destination to which to direct the file. If not 
specified, the default destination is assumed. 

form: An optional parameter which specifies the physical 
properties of the* output medium (e.g., paoer size, card 
type, printer train, ribbon color) upon which the data is 
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to be placed. If not specified, the default medium is 
assumed. 

copies: An optional parameter which specifies the number of 
copies to be placed on the output unit. If not specified, 
the default number of copies is assumed. 

status: returned request status. 



6.1.5 JM#SYSLOG 



The JM/^SYSLOG request is utilized by elements of IPLOS to 
effect the transfer of information to the SYSTEM LOG file. 

JM/^SYSLOG (recid, addr, bytes, status) 

recid: A SYSTEM LOG FILE record identifier code of the form 
tt/cc/ss/ (refer to section on System Logging for a 
discussion of Log File Record Identifier. 

addr: The PVA of the beginning of the information which is 
to be. transferred to the SYSTEM LOG FILE. 
Information whicn begins at the soecified address 
must be readable within the addressing context of 
the job in which the JM/r*SYSLOG request is issued. 

bytes: The number of bytes of information to be transferred 
to the SYSTEM LOG FILE. 

status: returned request status. 

Specification of all parameters is required. 
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6.1.6 JM#CLAIM 



The purpose of this request is to establish the maximum 
simultaneous usage of a class of peripheral devices by a job. A 
claim must be established for a class of devices before a 
JM/ZRESERVE request may be issued for devices of the ctasso 
Claims may not be increased while any devices are allocated to a 
job. Claims may be decreased at any time down to the number ^of 
devices currently allocated to the job. 

JM//CLAIM (unit_class» number, status) 

unit_class: the class of devices for which a claim is being 
made. 

numbers the number of devices of the class being claimed. 

status? returned request status. 



6.1.6.1 Loqi(; 

JM#CLAIM Request Processor Entry 
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6.1.7 JM#CHANGE_CLAIM 

The purpose of this request is to increase or decrease the 
number of units of a class previously claimed thf*ough JMtfCLAIM or 
JMf/CHA NG£_CLAIM request. Claims may not be increased while any 
devices are attached to the j ob. Claims may be decreased at any 
time down to the number of devices currently allocated to the 
job. 

JHy/CHANGE_CLAIM {unit_class, number, status) 

unit_class! the class of devices for which the claim is being 
modi f ied. 

number; the signed value to be added to th« existing claim. 

status: returned request status. 

6.1.7.1 Logic 

JM#CHANGE_CLAIM Request Processor Entry 



I Val id Unit Class 1 No I Yes 

} J -- — } + 

ICIaim increase I S Yes 1 No 

. . } 4- { 
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I I 1 1 + -I 

{Resultant claim exceed I I • Yes 1 No \ 

\ limit } I I } I 

1 1 I I { } + 

ILess than allocated I I 111 Yes I No 

+ 4- 4- + + f + 

lError status J X 1 X I X I I X I 

lAdjust claim I I 1 I X I IX 

{Signal scheduler I J I 1X1 IX 

{Return 1X1 XIX I XJX IX 

+ ,4- + 4- + 4- + 
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6.1.8 JM/^RtSERVE 

The purpose of this request is to register the requirement 
for a non-preemptible resource (file, volume set» or unit set. 
The allocation of the resource to the job will not take place 
until the issuance of a JM#ACQUIRE request. This request permits 
groups of resources to be acquired simultaneously. This reduces 
the possibility of deadlock and increases total system efficiency 
by not having some resources attached to a Job while it still 
needs others to continue execution. 

JM/^RESERVE (resource, usage, status) 

resources an (LNS)- structure defining the resource to be 
reserved. Allowable types are File Control Block, Volume 
Set Control Block and Unit Set Control Block. 

usaget indicates whether the resource is to be obtained for 
shared use or private to the job. 

statust returned request status. 
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6.1.8.1 LoHic 

JM#RESERVE 

Request processor entry point 
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RESERVEF Procedure 
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6.1.9 JM#CANCEL_RESERVE 

The purpose of this request is to cancel the effects of all 
JM#RESERVE requests issued since the last JM#ACQUIRE request. 

JM#CANCEL_RESERVE (status) 

status: returned request status. 

6.1.9.1 Logic 

JM/^CANCFL^RESERVE 



Request processor entry 
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6.1.10 JMy^ACQUIRE 



The purpose of this request is to cause the system to 
satisfy all requests previously established through the 
JM^RESERVE request. All outstanding requests must be satisfied 
before any additional JM^/RESERVE or JM//ACQUIRE requests can be 
issued . 

JM^ACQUIRE (queue, Cecbl, status) 

queues indicates whether the request for resources should be 
queued if they ccinnot all be satisfied imnediately or- the 
JM#ACQUIRE be terminated with none of the allocations 

made. 

ecbl optional parameter which names an event to be PM#CAUSED 
when all outstanding requests have been satisfied. When 
the "queue" parameter indicates immediate termination^ the 
specification of an ecb is not permitted and if present 
will result in an error* status. 

status! returned request status. 
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6.1.11 JM#RETURN 



The purpose of this request is to return a file volume set 
or unit set previously allocated to a Job through 
JM#REStRVE/JM#ACQUIRE commands. If a file is named, then only 
the file is returned. If a volume set is named then all files on 
the volume set that aire attached to the | ob and the volume set 
are returned. If» in this case? the unit set was supplied by the 
system, it is also returned. If the unit set was supplied by the 
job, it is left allocated to the job. If a unit set is named, 
the attached files, volume set and unit set are returned. 

JM^/RETURN (resource, C c I aim_di sposit ioni , status) 

resources the (LNS) structure defining the resource to be 
returned. Allowable types are File Control Block, Volume 
Set Control Block, and Unit Set Control Block. 

cl aim_disposit ion ! if the unit set involved is returned, 
indicates whether or not to reduce the claim for the 
appropriate device class. 



status: returned request status. 
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6.1.11.1 Logic 

JM#RETURN 

Request processor entry point 



lis JM#ACQUIRE outstanding lYes 

I I — 

lis resource a FOB I 

I I 

lis resource a VSCB I 

I I 

I Is resource a USCB I 



JError status 
ICal I RETURNF 
ICal I RETURNV 
ICal I RETURNU 
•Return 



I X 
I 
I 
I 

I X 
- + 



No 



No 
+ --— 

Yes I 

I-— + 1 

lYesI No I 

I I +--I 

I lYeslNol 



I 

X I 



IX I 
I 



I 
IX'. II 

I I X I I 

S X I X I X IX I 

+ + + +--+ 



RETURNF procedure 



lis File attached 



-+ + + 

I Yes I No I 



ICall DETACHF 
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X 


1 


1 


JSignal Resource Allocator 


S 


X 


I 
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lError status 


1 




1 X 
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1 Return 
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1 X 
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- + 
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RETURNV Procedure 



+ . ^- 

lls VSCB a! located 

1 

lAny more attached files 


system 


INol 

1 r 


resi 


— 


— 


Yes 
No 


lis volume set shareable 
1 




n 


Y 


es 


1 


No 


ICal led by RETURNU 
1 


reslNolYesI No 


IWas unit set supplied by 




1 


1 


lYesINo 


1 Error status 

IPicK first attached FCB 

ICal 1 RETURNF 

ILoop to RETURNV 

IMarK USCB not reserved 

1 Signal resource a 1 locator 

ICal 1 RETURNU 

IReturn 




IX 

IX 




X 
X 
X 




X 
X 
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1 
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1 

IX 

IX 

IX 

IX 


IX 
IX 

IX 


1 1 
1 1 
1 1 
1 1 

1 X IX 
1 X IX 
1 X 1 
IX IX 



RETURNU Procedure 



4. + 

Is USCB allocated I No I Yes 

I — — I- +- — • 

Is VSCB attached I I Yes I No 

J J + \ 4. 

Is claim to be reduced I I Yes I No I Yes I No 

— + + + +-- + 

Error Status I X I I I I 

Mark USCB not attached I I X I X I X I X 

Cal I RETURNV I I X I X I I 

Signal resource allocator I I X I X I X I X 

Reduce number claimed I I X I I X i 

Return IXIXIXIXIX 
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6.0 JOB MANAGEMENT REQUESTS 
6.1.12 JM#SET_PRIORITY 
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6.1.12 JM#SET_PRIORITY 

The purpose of this request Is to establish or change the 
base priority of a job. 

JM/^SET_PRIORITY ( j ob,pr ior i ty , status ) 

Job: LNS descriptor of the Job Control Block or alias of the 
job to have its priority changed. 

priority: The value of 1..15 to set the priority. 

status: returned request status. 

Example: JM#SET_PRIORITY (this_j ob, ' 7' , status) 5 

6.1.13 JM^SET_CLASS 

The purpose of this request is to change the class of a 
job. 

JM#SET_CLASS ( j ob,c lass, status ) 

job: LNS descriptor of the Job Control Block or alias of the 
job to have its class changed. 

class: The value (l..n) where n is the highest class number 
to set the class. 

status: returned request status. 

Example: JM/ASET_CLASS (this J ob,xact ion , status) ; 

6.1.1^ JM#GET_CAT 

The purpose of this request is to get a copy of a record of 
the Class Attribute Table. 

JM#GET_CAT (class»buffer, status) 

class: The class number of the record desired. 

NCR/CDC PRIVATE REV 27 MAY 75 
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6.1.1^ JM#GET_CAT 



buffer: The location to put the copy of the record, 
status* returned request status. 

6.1.15 JM#REPLACE_CAT 

The purpose of this request is to replace a Class Attribute 
Table record with a new one. 

JM#REPLACE_CAT (c lass ,buf f ertS tatus) 

classi The Class number of the record to be replaced. 

buffer: Location of the new record. 

status: returned request status. 

6.1.16 JM#GET__CPLT 

The purpose of this request is to get a copy of a Class 
Priority Level Table record. 

JM#GET_CPLT (cpl, buff er, status) 

CPL: Class priority level of the desired record. 

buffer: Location into which to place the record. 

status: returned request status. 

6.1.17 JM#REPLACE_CPLT 

The purpose of this request is to replace a Class Priority 
Level Table record with a new one. 

JM#REPLACE_CPLT ( CD I ,bu f f er ,status) 

cpl: Class priority level of the record to be replaced. 

buffer: Location of the new record. 

status: returned request status. 
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6.0 JOB MANAGEMENT REQUESTS 
6.1.15 JM#GET_CTT 



6.1.18 JM#GET_CTT 

The purpose of this request is to get a copy of a class 
Transition Table record. 

JM#GET_CTT (class, buffer, status) 

class: The class number of the desired record. 

buffer: The buffer into which to place the record. 

status: returned request status. 

6.1.19 JM#REPLACE_CTT 

The purpose of this request is to replace a Class Transition 
Table record with a new one. 

JM#REPLACE_CTT (c lass , buff er, status ) 

Class: The class of the record to be replaced. 

buffer: Location of the new record. 

status: returned request status. 

6.1.20 JMf^GET^SCT 

The purpose of this request is to get a copy of the 
Scheduler Control Table. 

JM#GET_SCT (buff er, status) 

buffer: Location to place the SCT. 

status: returned request status. 

6.1.21 JM#REPLACE_SCT 



The purpose of this request is to replace the current 
Scheduler Control Table with a new one. 
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6.0 JOB MANAGEMENT REQUESTS 
6.2.1 DEFINITION OF STATUS CODES 



JM#R£PLAG£_SCT ( but f er, sta tus) 
buffer: The location of the new SCT. 
status? returned reauest status. 

6«2 RE QUES T STATUS 



Each terminating request processor returns status 
information, in a coded format, which describes the disposition 
of the request. 



6.2.1 DEFINITION OF STATUS CODES 



Accepted 



JH 00 
^ JM 000 



Re J ect eci 



accepted and completed 
accepted and queued for service 



Parameter Error Rejects 



8 JM 101 
8 JM 102 
a JM 103 
6 JM lOif 
6 JM 10 5 
8 JM 106 
8 JM 10 7 



3 JM IFF 



required parameter not specified 
invalid parameter type 
invalid parameter value 
undefined LNS variable name 
duplicate LNS variable name 
invalid address specified 
(undefined status code) 



(undef ined status code) 



Functional Error Rejects 

3 JM 201 attempted to submit interactive job 
8 JM 202 disk file not permanent 
8 JM 203 (undefined status code) 
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R JM 2FF (undefined status code) 



Internal Condition Rejects 



C JM 901 
C JM 90 2 
C JM 903 



C JM 9FF 



system limits exceeded 
no table space available 
(undefined status code) 



(undefined status code) 



Internal Error Rejects 

F JM AOl LNS variable not in proper LNS segment 
F JM A02 (undefined status code) 



F JM AFF (undefined status code) 
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6.2.2 STATUS COOES BY REQUEST 
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7.0 PR OCESS DESC RIPIIPN3 



7.1 SUBMIT REQUEST PROCESSOR 
To be suppi led 
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7.1.1 DECISION TABLES 



Is • FILE ■ <rnaffla> parameter specified 


V 


w 


Sots fCB ■ <fnano reside in LNS 


V 


N 




Boes FCB ■ <fnaine> describe disk or interactive file 


Y 


N 




■ 
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N 
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Does FCB « <fnaiiie describe a disk resident file 
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Y 
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N 








Is the disk resident file pernanent 
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N 










Is a JOB = <jname> parameter specified 
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Does Alias = <jnaiae> reside in SLLNS 
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1. Set return status : Rejects FILE parameter absent 






























X 


2. Set return status : Reject; FCB « <fnaniG> undefined 




























X 




3. Set return status : Reject*, Illegal input file nediun 


























X 






M. Set return status : Reject; Input file not on disk 
























X 








S. Set return status : Reject; Disk file not permanent 














X 








X 










b. Set return status : Reject; <j'name> not unique " 




















X 












7. Set return status : Reject; JOB parameter absent 
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a. Set return status : Reject; JCB = <jname> undefined 
T. Declare a JCB = <unique"> in SGLNS 




X 
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"~ 


ID. Declare an Alias = <jname> in SLLNS 
11. Set JCB name into the Alias variable 


















X 






























X 










'■ 


—' 


* 12. Copy User id. from JCB. ALPHA to JCB. BETA 
















X 


X 












■~" 


13. Copy Account id. from JCB. ALPHA to JCB-BETA 

m. Copy PII from JCB. ALPHA to JCB. BETA 

IS. Set Job Type field of JCB. BETA to "User Job" 




. 












X 
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It. Copy Initial Priority from JCB. ALPHA to JCB. BETA 

17. Set Job Class field of JCB-BETA to "batch" 

la. Set Job Class field of JCB. BETA to "interactive" 
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n. Set name of JCB into JCB.BETA 

20. Set current date/time into JCB.BETA 
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21. Set Job Status field of JCB.BETA to "knoun/not estab." 


X 
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22. Obtain pern, file name from FCB - place in JCB.BETA 


X 






X 
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23. Set ENfl field of JCB.BETA with ENfl parameter value 
2M. Set DISP field of JCB.BETA with DISP parameter value 
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2S. Send SIGNAL containing JCB-BETA name to Job Estab. 
2t. Uait for reply signal from Job Establisher 
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27. Proceed with Phase II when reply signal arrives 








X 
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X 














2a. RETURN immediately to caller {with return status! 
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ALPHA is used here to designate entities associated with 
the submitter Job; BETA designates entities associated 
with the Job being submitted. 



SUBMIT REQUEST PROCESSOR - PHASE I 
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7,1. 1 DECISION TABLES 
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7.0 PROCESS DESCRIPTIONS 
7.2 JOB ESTABLISHER TASK 



Is Alpha the System Job 

Does status from Job Establisher indicate "reject" 

Did Phase I create an Alias of <jname> in SLLNS 



1. Link JCB.BETA into ALPHA'S Submit thread 

2. REMOVE SLLNS Alias = <jname> 

3. REMOVE JCB.BETA previously declared by Phase I 

M. Set return status : -CThat returned by Job Establisher! 

S- RETURN to caller with return status 
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7.2 J08_£SIABUSil^£«IASK 
To bf? suDPl led 
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7.0 PROCESS DESCRIPTIONS 
7.3 QUEUED JOB MONITOR 



7.2.1 DECISION TABLE 



Is tha signal-specified JCB in SCLNS 

Uas a KJL entry previously assigned -Ci«e' 

Is a KJL entry available for assignment 

Does the JCB specify an interactive job 

Is I.crnt<I.max 

Is B.crnt<B.max 

Does the JCB specify queue permission 



1. Set return status s Rejects JCB ■<narae> undefined 

2- Set return status s Reject; KJL limits exceeded 

3. Set return status : Reject; Interactive limits exceeded 

t{. Set return status : Reject; Batch limits exceeded 

S. Acquire a KJL entry 

b. Inter-link JCB and KJL 

7. Set KJL entry status : flueued for Establishment 

a. Set KJL entry priority froo JCB 

I. Set JCB status field : Known/not established 
10* Set return status : Accepted and flueued 

II. Issue create:_ai>dress_space 

IS. Set KJL entry status : Establish - swapped in 

13. Set JCB status field : Est. - not initiated 

m. Trigger initial execution of SEd.flTR in new Job 

15- Set I.crnt » I.crnt ♦ 1 

Its. Set B.crnt = B.crnt ♦ 1 

17. Set return status : Acceptedi established 

U. Send reply signal with return status to requestor 
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7.3 QUEUED JOB MO NITQR 
To be suppi ied 
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7.3.1 DECISION TABLES 



A. Is the length of KJL "queue" thread t 



1. Set index -CiJ to first KJL "queue" thread entry 

2. Set index -Cjl to «i>. nextJ 
3* Proceed with Phase II 

1. Uait on time event 

5. Proceed at -CA> when Uait is satisfied 
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QUEUED JOB MONITOR - PHASE I 
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Is -CjJ « 

Is «j>-priority}>«i>.priority> 



1. Set •Ci> = -Cjl 

2. Set -CjJ « «j>.next> 
3- Proceed at •CA> 

M. Extract Mi>.jcbid> 

5. Send signal to Job Establisher 

b- Uait for reply signal from Job Establisher 

7. Proceed uith Phase III when Uait is satisfied 
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7.^ SYSL06 REQUEST PROCESSOR 



Uas establishRent request accepted 
Was the Job established 



blait on time event 

Transmit a message to System Error stream 

Advise System Operator of the error 

Uait for System Operator's acknowledgement 

Proceed with Phase I 
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7.^ SYSLOG REQUEST PROC ESSO R 

T o be suppi led. 
7.if.l DECISION TABLE 



Are REai>i LOCi and LENGTH paraneteps specified 
Is TYPE field of RECID parametep valid 
Is addpess specified fop LOC valid 
Is value specified fop LENGTH valid 



Set retupn status: Rejects requiped papameter absent 
Set peturn status: Rejects invalid parametep value 
Set petupn. status: Rejects invalid menopy addpess 
AcquiPB contiguous nemopy sufficient fop pecopd 

headep and text in a global segment 
Constpuct pecord headep in acquired global nemopy 
Append text to headep in global nemopy 
« Send signal to LOGTASK in System Job 

Set peturn status: Accepted and tpansnitted 
Retupn to pequestop with status 



Signal Includes addpess of the pecopd In the global 
segment and the length of the recopd 



Y 


N 


Y 


N 




Y 


N 




-1- 


N 












X 




X 




X 








X 






X 










X 










X 










X 










X 










^ 










X 


X 


■JT- 


-ir- 


X 



Jt1#SYSL0G REaUEST PROC 



1 

2 
3 
if 
5 
6 
7 
8 
9 
10 
11 
12 
13 
l«f 
15 
16 
17 
18 
19 
20 
21 
22 
23 
Zk 
25 
26 
27 
28 
29 
30 
31 
32 
33 
Zk 
35 
36 
37 
38 
39 
tfO 
kl 
kZ 
kZ 
kk 
k5 

t*e 

tf8 



NCR/CDC PRIVATE REV 27 MAY 75 



NCR/CDC PRIVATE REV 27 MAY 75 



lOVANCED SYSTEMS LABORATORY 
[PLOS CDS - JOB MANAGEMENT 



CHPQ^O^ 



7-11 
75/05/27 



7.0 PROCESS DESCRIPTIONS 

7.5 DIRECT REQUEST PROCESSOR 



ADVANCED SYSTEMS LABORATORY 
IPLOS GOS - JOB MANAGEMENT 



CHPO^O^ 



7-12 
75/05/27 



7.0 PROCESS DESCRIPTIONS 

7.5 DIRECT REQUEST PROCESSOR 



7.5 



jO^ESSOS 



The JM#DIRECT request Is one of the Task Services in the 
user job. The request is processed to completion before control 
is returned to the requestor. Note that the JM#DIRECT request 
does not initiate routing? it only associates a destination with 
a file. The issuance of a subsequent JM#OIRECr request or a 
JM^ROUTE with explicit parameters will taKe precedence over a 
previous JM#DIRECT request. 

During the init i I izat ion of every job, a local directed file 
list will be provided in the local LNS segment. Whenever a 
JM#DIRECT request is issued, an entry containing the file along 
with the explicit parameters that were specified on the request 
will be placed in the local directed file list. When a JM#ROUTE 
request is issued, the local directed file list will be 
consulted. If the file appears, the explicit parameters in the 
entry will be used in lieu of the default values for the JM#ROUTE 
request. That entry in the local directed file list will then be 
removed. 

If a subsequent JM/^DIRECT request is issued for the same 
file, all informatiom from the former request will be discarded. 

The destination will probably be the name of an output 
queue. During < and after) the autoload sequence for the system, 
a number of standard output queues will be declared in Global 
LNS; they will then be QNSYSTEMed to one or more output units. 
Subsequently, whan a file is placed in a given output queue, the 
contents will be transferred to the appropriate output unit. 

Note that the above paragraph does not preclude the use of 
an alias for the output queue. In fact, the use of an alias for 
the destination wi I I likely be the normal mode of operation since 
the presence of that mechanism allows for the use of universal 
destination names such as PRINTER and PUNCH. The system profile 
would then provide the relationship between these names and the 
output queues. Thus, a central site which se'^ved many users 
would need only one queue for each of the standard default 
destinations. 

Additional output queues would be needed for each additional 
unique type of output unit. Then, if a pa-^ticular user was 
temporarily offsite or needed to use a non-standard output unit, 
it would be an extremely simple matter for him to redefine the 
alias in order to direct the file to a different unit without any 
changes in the actual programs. 
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Tables Required 

Local Directed File List 

A Local Directed File List (LOFL) will have entries which contain 
the following information! 

o File - the descriptor of the fcb 
o Destination - the descriptor of the qcb 
o Form - The actual string of characters giving 

the form to be used 
o Copies - The actual number of copies 

7.6 RETRACT REQUE ST 



The JM^RETRACT request is one of the Task Services in the 
user job. The request is processed to completion before control 
is returned to the requestor. 

During the ini t i I i zation of every job, a local directed file 
list will be provided in the local LNS segment. Whenever a 
JM#DIRECT request is issued, an entry containing the file along 
with the explicit parameters that were specified on the request 
will be placed in the local directed file list. When a 
JM#RETRACT request is issued, the local directed file list will 
be consulted. If the file appears, that entry will be removed. 



7.7 



>T PROQ^SSQR 



The JM#ROUTE request is one of the Task Services in the user 
job. The request is processed to completion before control is 
returned to the requestor. JM/^ROUTE will attach the specified 
file to the output queue indicated by the specified destination. 

The destination will probably be the name of an output 
queue. A number of standard output queues will be declared in 
Global LNS; they will then be ONSYSTEMed to one or more output 
Subsequently, when a file is placed in a given output 
the contents will be transferred to the appropriate output 



units, 
queue, 
unit. 



Note that the above paragraph does not preclude the use of 
an alias for the output queue. In fact, the use of an alias for 
the destination will likely be the normal mode of operation ^ince 
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the presence of that mechanism allows for the use of universal 
destination names such as PRINTER and PUNCH* The system profile 



nd 



e 
the 



would then provide the relationship between these names a 

.a._..A Thus? a central site which served many users 

for each of the standard default 



output queues. 

would need only one queue 

destinations. 



Additional output Queues would be needed for each additional 
unique type of output unit. Then, if a particular user was 
temporarily off site or heeded to use a non-standard output unit, 
it would be an extremely simple matter for him to redefine the 
alias in order to route the file to a different unit without any 
changes in the actual programs. 

It should also be noted that some sites may require a 
separation between the different users who wish to transfer data 
to the output unit. High priority files could be placed in one 
output queue while lower priority files go to a second or a third 
output queue. Storage space restrictions might require the 
operator to place all low priority files on backup storage and 
retrieve them for processing at a later time. The use of an 
alias which is available to both the system and the user makes 
such examples easy to handle. 

When any explicit parameters in the JM^ROUTE request are 
omitted, a local directed file list for the job will be accessed 
to determine if a JM^DIRECT request is outstanding on the 
specified file. If one exists, the explicit values therein will 
be used to override all optional parameters left unspecified in 
the JMf^ROUTE request, and the entry in the focal directed file 
list for the specified file will be removed. Otherwise, standard 
default values are assumed which will be determined from entries 
in the local LNS segment. 

If the file is temporary, JH^ROUTE will make the file 
permanent under a unique new name. However, JMf^ROUTE will 
include in the output queue a directive to release the file after 
the file has been routed to its destination. 



Tables Required 

Output Queue 

Each Output Queue entry will contain the fol lowing inf ormationJ 
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o File 

o Form 

o Copies 

o Job ID 



the descriptor of the fcb of the file 

the actual string of characters 

the actual number of copies 

the descriptor of the |cb of the job 

which submitted the ROUTE request 



7.8 FILE ROUTER 



File Router will periodically ascertain the state of all 
known output queues. When appropriate, File Router will activate 
and send to an instance of the specified Output Distributor its 
associated output queues. A set of tables will be used to 
control and direct the functions which File Router performs, 
i.e., File Router will be table driven. 



Function Description 

There will be only one File Router task in the System Job. 
Periodically, it will be invoked. Its sole function will be to 
check if there are any idle output units which are associated 
with one or more active, non-empty output queues. Whenever, it 
finds one in that condition, File Router will determine if the 
number of currently active Output Distributors allows an 
additional one to be SPAWNed. If that may be done, File Router 
will hand off to the new Output Distributor subtask the output 
unit and its associated set of output queues. 



Tab les Required 

Known Output Queue List 

Each entry in the Known Output Queue List will contain the 
following information! 

Queue - the descriptor of the qcb 

o Status - the output queue may be either active 

or inactive 
o Unit List - the descriptor of the list of output 

units to which the associated output 
queues are to be drained 
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Unit 


o 


Status 





Subtask 





File 


o 


Queue List 



Known Output Unit List 

Each entry in the Known Output Unit List will contain the 
following information: 

the descriptor of the ucb 

the output unit may be either active 

or inactive 

the descriptor of the stcb 

the descriptor of the current file's 

fcb 

the descriptor of ine list of output 

queues from which the output unit is 

to be drained 



7.8,1 FILE ROUTER DIRECTOR 



File Router Director will be used to modify and change those 
tables which are used to control and direct the functions 
performed by File Router. This program will be available to 
system programs which have operator authorization level security 
to read and/or modify these tables via the standard system 
interface. 



Function Description 

Control and direction 
Router should normally requir 
usual mode of operation, t 
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Consequently, although the fun 
are inherently part of Fil 
divorced from that program, 
required to ensure coordinatio 



of the fu 
e infrequ 
he standa 
the table 
ges in pri 
tive to th 
ile Router 
ctions per 
e Router, 
Synchro 
n between 



ncti 
ent 
rd 

s us 
nter 
e nu 

Dir 
form 

the 
niza 
the 



ons per 
attent 
prof i ! e 
ed oy 

forms , 
mber o 
ector w 
ed oy 
y have 
tion I 
two pro 



formed 

ion • 
used 
Fi le 
there 



by Fi le 
In the 
by an 
Router, 
win be 



f times that 
ill be needed, 
this program 
purposely been 
ocks will be 
grams. 



File Router Director will be able to receive commands from 
an operator communications program which may wish to regulate 
and/or modify the standard mode of operation for File Router. 
The following primitives will be accepted which may be used 
either singly or in combination to achieve the effect d.eslred by 
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the operator's command. 

(a) REGISTER (queue__l ist,unit_ I ist, status ) 

Each output queue that File Router is to handle must be 
entered into the tables which control and direct the 
functions of File Router. An error status will be returned 
if an output queue does not exist or is already registered. 

(b) REMOVE (queue_list, unit_list, status) 

This primitive will remove the specified output queues from 
the tables used to control and direct the functions of File 
Router. If an output queue is active or is not presently 
registered, an error status will be returned. 

(c) ACTIVATE (queue_l ist, unit^list, status) 

This primitive will change the status of the specified 
queues from inactive to active. A number of the output 
queues, which are registered in the tables which control 
File Router, may be designated as inactive. Such output 
queues will retain all of their attributes, but will not be 
connected to an Output Distributor. If the output queue was 
already active or it was not registered with File Router, an 
error status will be returned. 

(d) SUSPEND (queue_l ist,unit_l ist, status) 

This primitive will change the status of the specified 
queues from active to inactive. A number of the output 
queues, which are registered in the tables which control 
File Router, may be designated as inactive. Such output 
queues will retain all of their attributes, but will not be 
dispatched to an Output Distributor. If the output queue 
was already inactive or it was not registered with File 
Router, an error status will be returned. 

(e) ALTER (Out put_DistrIbutor, unit , status ) 

This primitive mafy be used to alter the Output Distributor 
associated with an output unit. 

(f) LIST (queue, status) 

to be supol led 

(g) FORM (type, status) 
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to be supDl led 



7.8.2 OUTPUT DISTRIBUTOR 



An Output Distributor will be used to transt er data from 
files which are attached to a set of outout queues. When first 
given control? an output unit will also be specified to which the 
data will be transferred. 

In addition, an Output Distributor will accept a number of 
primitive directives to control the processing of the files. 

Function Description 

There will be several different flavors of Output 
Distributor, one for each different type of output unit. (At 
present, three different types are known - printer, punch, 713 
terminal.) Each unique Output Distributor may have several 
instances of itself active at any one time depending on the 
activity in the output Queues, the mix of output units available, 
and the maximum number of instances allowed for all Output 
Distributors. 

When an Output Distributor is SPAWNed, it will be given a 
set of outout queues and an output unit. It will then proceed to 
transfer the data from the files in the output queues to the 
unit. The following steps outline the set of actions performed 
upon each file. 

(a) Find the highest priority file attached to the given set of 
queues. 

(b) Determine the file type. 

(c ) Determine the form type required. 

(d) If the correct form is not on the unit, request the operator 

to change forms and wait for the reply. 

(e > Select the Conversion Routine which performs the correct 
transfer of data from the file to the unit. 



(f) Open the file. 

(g ) Transfer the file. 
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(h) Close the file. 

(i) Release the file if that indication is present in the output 
queue record. 

(]) Remove the output queue record for that file. 

(K) Update the accounting log for the job which submitted the 
JM#ROUTE request to reflect the charges incurred to transfer 
the file to the outout unit. 

(I) ChecK the proceed indicators. 

In addition to performing the basic function of directing 
the data from the file to the output unit. Output Distributor 
will be able to receive commands from an operator communication 
program which may wish to request and/or modify the standard mode 
of operation for any particular Output Distributor. The 
following primitives will be accepted which may be used either 
singly or in combination to achieve the effect desired by the 
operator's commands 

(a) CONTINUE 

This primitive will direct the Output Distributor to resume 
processing at the point where it is currently situated. If 
processing was interrupted in the middle of a file, and no 
other primitives have been issued, output to the unit will 
resume where it left off- If the Output Distributor is not 
in a hold mode, a null operation will result. 

(b) HOLD 

This primitive will direct the Output Distributor to cease 
processing. The input pointer will not be altered. 
However, all outout buffers will be cleared. If the Output 
Distributor is already in a hold mode, a null operation will 
resu It. 

(c) CANCEL 

This primitive will direct the Output Distributor to skip to 
the EOF for the current file to be (or being) processed. It 
is not necessary for the Output Distributor to receive a 
HOLD directive prior to the CANCEL. All subsequent 
processing will then take place in the usual manner. 



(d) RESTART 
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This primitive will direct the Output Distributor to reset 
the input pointer to the beginning of the fiie being (or to 
be - which then becomes a null operation) processed. It is 
not necessary for the Output Distributor to receive a HOLD 
directive prior to the RESTART. 
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This primitive will direct the Output Distributor to skip n 
records of output to the unit (n pages if the unit is a 
printer). The para'meter n may be negative in which case the 
output will be repeated. If n is such that the extent of 
the file being output is exceeded (in either direction)* the 
default will be to the start or end of the file. The 
default value for n is one. 



(g) PROCESS (n) 
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(h) PROCEED (n) 

This primitive will direct the Output Distributor to 
transfer the contents of' the next n files to the unit after 
which the Output Distributor will go into a HOLD condition. 
It is not necessary for the Output Distributor to receive a 
HOLD directive prior to the PROCEED. Note also that if the 
Output Distributor is in a HOLD condition, the PROCEED 
directive will not cause any data to be transferred. Only a 
CONTINUE directive has that effect. The default value for n 
is one. 



(1) FINISH 
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Conversion Routine Types 
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(a) COPY 



COPY does not change the data format in any way. Its 
primary purpose is to allow for any file of any organization 
to be transferred to any unit (with presumably a default 
organization of sequential). In addition, when the output 
record exceeds the physical device size, the extra 
characters will be placed upon succeeding output records. 
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In the case of a printer, these succeeding records will be 
preceded by a blank character. 



(b) COPYTK 



COPYTK is identical to COPY, but with the additional feature 
that each record of data transmitted will be truncated to a 
specified number of characters (probably tha physical device 
size). This feature would be used in the case of a punch 
unit beinq the output medium and the source file having more 
than the allowed number of characters per record. 



(c) COPYSB 



COPYSB is identical to COPYTK, but with the additional 
feature that each record of data transmitted will be 
preceded by a blank character. 



(d) DUMP 



DUMP cannot be defined at this point. It is expected to 
allow ref ormattinqi of the data in a file such that object 
files and libraries (to give but two examples) would have a 
meaningful listing if output was placed on a printer. 



Fi I e Types 

(a) Source 

(b) Print 
(c ) Punch 

(d) Termina I 

(e) Object Program 

(f) Library of Programs 



Output Unit Types 
(a) Printer 
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(b) Punch 

(c) Terminal 



Conversion Matrix 



I printer I punch I terminal I 
^ f + : + ^ 

I null I COPYTK I . COPYTK I COPYTK I 
f ^- 4- + + 

I source I COPYSB I COPYTK I COPYTK 1 
+ + i. + + 

I print I COPY ' I COPYTK I COPYTK I 

+ i- 4- 4- + 

J punch I COPYSB I COPY \ COPYTK I 

+ + i- + f 

I terminal I COPYSB I COPYTK I COPY I 

+ f + + + 

I object I DUMP I DUMP J DUMP I 

f + 4- 4- .+ 

I library I DUMP I DUMP I DUMP I 

4- 4- 4- + ^ 



7.9 SYSTEM ACCESS MANAGER 



System Access Manager runs as a single task within the 
System Job. Its primary purpose is the recognition of new input 
from system input devices and the submission of such inputs as 
new jobs to the system. 



7.9.1 DESCRIPTION OF FUNCTIONS 



The major function of System Access Manager is the 
recognition of events caused by the Active Device Detector 
indicating that a system input device is ready to transmit data 
to the system. Occurrence of such events will cause System 
Access Manager to scan the System Input Device list to determine 
which device became ready. The actions of Systeii Access Manager 
will be different depending upon whether the input is from a 
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batch or interactive source. 



7.9.1.1 Interacti ve Inp ut 



If the input medium is an interactive terminal then System 
Access Manager wiM declare a uniquely named Job Control Block 
and a uniquely named File Control BlocK in System Global LNS. 
The File associated with this File Control Block is the 
interactive terminal and will be specified as the Standard Input 
File on the SUBMIT request. System Acess Manager will then issue 
the SUBMIT request to Job Management in order that the input will 
be processed. 

A count will be maintained of the number of interactive 
devices logged in at any one time. If this count exceeds a 
specified system limit, then a message will be sent to the user 
requesting him to try again at a later time and the user's line 
will be disconnected. 



7. 9. 1 . 2 B atch I nput 



If the input medium is a batch device, then System Access 
Manager will declare a uniquely named Job Control Block and a 
uniquely named File Control Block in System Global LNS and will 
then invoke the Input Stager to process the input from that 
device. Upon return from Input Stager, System Access Manager 
will issue a SUBMIT request to Job Management to process the fife 
into which the Input Stager has placed a logical input stream. 
System Access Manager will then reinvoke the Input Stager in case 
there is more input on the same device. 

A Count will be maintained of the number of activations of 
Input Stager. If the number of active Input Stagers reaches a 
system defined maximum then System Access Manager wil I queue any 
further requests for Input until such time as there are resources 
to process the input. 
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7.9.2 EXTERNAL DATA STRUCTURES 



The following externally defined data structures are used by 
System Access Manager, 



Job Control Block. 

System Access Manager declares a Job Control Block for each 
new job entering the system. The following information is placed 
in the Job Control Block. 

o Job Class, that is Batch or Interactive. 

o PII, the Primal Invocator Identity. 

Fi le Contro I 91 ock. 

System Access Manager declares a File Control Block for each 
Input Device and also a File Control Block for every mass storage 
file required by Input Stager, The individual fields within each 
File Control Block are filled in by Data Management requests. 
File Formats are defined below. 

Event Control Block. 

Event Control Blocks will be used to communicate between 
System Access Manager and the Active Device Detector. 

Subtask Control Block. 

System Access Manager will have a Subtask Control Block for 
use in the SPAWN request to invoke Input Stager. 

Configuration Manager Unit Tables. 

System Access Manager will access these Unit Tables in order 
to determine which System Input Device has become ready for 
input. 
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7.9.3 INTERNAL DATA STRUCTURES 



System Access Manager will have one data str^ucture internal 
to itself. This data structure will be a table of pointers to 
the System Inout Device Tables? each pointer pointing at a system 
input device which has been placed 'Onsystem*. The information 
required by System Access Manager in these tables is specified 
below. 



System Input Device Tables. 

System Access Manager will require information specific to 
the devices from which it receives input. A preliminary idea of 
the type of information required is given below. These 
descriptions are by no means rigorous or definitivet but give 
some notion of the information required. 



Type. 



Device_Classes = ( Interactive_Dev iceiBatch_Device ) 
Device_Types = ( Card^Tape, Dis k. Terminal tetc ) ? 

Pr imal_Invocator_Identity = Record 

Site : Integer 9 

Terminal 8 Integer , 

Unit t Integer 9 
Recend « 



System_Input_Oevice_Description = Record 

Device_Ident i f i er : Prima l__Invocator_Ident it y « 

Ready_ Indicator J Boolean « 

Device_Type : Device_Types 9 

Device_Class s Device_Classes 1 
Recend ; 



7.9.^ OPERATOR COMMUNICATIONS INTERFACE 

System Access Manager has three request processors which 
interface with Operator Communications. These a'*e t 

'Onsystem* request. 

•Offsystem' request. 

NCR/CDC PRIVATE REV 27 MAY 75 
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' Of f I ine' request. 

The 'Onsystem* request will notify System Access Manager 
that a device is a system input device and will cause System 
Access Manager to make an entry in its system input device 
table. The 'Offsystem' request will cause the relevant table 
entry to be deleted. The 'Offline' request is necessary because 
it is feasible that a device which is 'Onsystem* can be taken 
'Offline' without first taking it 'Offsystem*. 



7.9.^.1 



tem * Request Process or 



The format of the 'Onsystem' request is as follows. ,^ 

SA/^ONSYSTEM( Uni t_Descrip tor , Status ) 

Unit_Descri ptor : The Unit_Descr iptor parameter the LNS 
descriptor of the device in Configuration Manager's 
Unit tab I es . 

Status J Status is the identifier of the status record 
returned to the caller by System Access Manager. The 
status codes are defined below. 

7.9.^.2 'O ffsys tem* Request Proces s or 

The format ot the 'Offsystem' request is as follows. 

SA#OFFSYSTEM( Un it_Descri ptor , Status ) 

Unit_Descri ptor s The Unit_Descriptor pa-^ameter the LNS 
descriptor of the device in Configuration Manager's 
Unit tables. 

Status I Status is the identifier of the status record 
returned to the caller by System Access Manager. The 
status codes are defined below. 

7.9.^.3 ' Offline' Request Processo r 

The format of the 'Offline' request is as- follows. 

NCR/CDC PRIVATE REV 27 MAY 75 
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SA#OFFLINE( Un i t_Descr ipt or » Status ) 

Unit_J escriptor J The Unit_Descri ptor parameter the LNS 
descriptor of the device in Configuration Manager's 
Unit tables. 

Status : Status is the identifier of the status record 
returned to the caller by System Access Manager. The 
status codes are def ined below. 



7. 9. i+. 3 . 1 STATUS CODE§^ 

The Status Codes returned by System Access Manager are as 
fo I I ows. 

SA 000 Request successful ly executed. 

^ SA (301 Onsystem request for device already Onsystem. 

^ SA 002 Offsystem request for device already Offsystem. 

^ SA 003 Offline request for device already Offsystem. 

3 SA 00^ Onsystem request for device which is not an Input 

Device. 

3 SA 005 Offsystem request fo~ a device which is not an Input 

Device. 

7.9.5 SUBMIT FORMATS. 

There are two separate formats for the SUBMIT request to Job 
Management depending on whether the input is from a batch or an 
interactive device. The two different formats a'^e as follows. 

Batch Input. 

JM#SU8MIT( FOB , JCB , ENQ=q , OISP=P , Status ) 

This request indicates that the file specified by FCB will 
be purged on job completion and that the ]ob will be queued if 
there are insufficient resources to process the ^ob. 

Interactive Input. 
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JM/^SUBMITC FCR , JCB , ENQ=I , OISP=K , Status ) 

This request indicates that in the event of there being 
insufficient resources to process the job»submit will be rejected. 



7.9.5.1 Inp ut Stager. 



Input Stager runs as a subtasK of System Access Manager. It 
is responsible for transferring data from system input devices to 
mass storage staging files. 

The functions performed by Input Stager are as follows. 



Creates a file whose File Control 
declared by System Access Manager. 



Block has been 



Copies data from the Input File to the mass storage 
staging File until a 'fence' card has been read. 

Saves the mass storage staging File. 

Returns to System Access Manager with an indicator 
stating whether 'device end' was encountered on the 
input device. 

Input Stager will report on staged jobs in the system 
log. 



7. 9. 5. 2 Hed ge C ards. 



To cater for those cases where large quantities of data are 
being staged from cards and the user wishes to take precautions 
against system crashes? a new type of data separator will be 
provided. This new type of card is known as a HEDGE card. Input 
Stager will always remember the input deck as far as the last 
Hedge card which it encounters* such that if a crash does occur* 
the user need only reinput the portion of his data following the 
last successfully read Hedge card. 
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In keeping with 'Fence* cgrds. Hedge cards are identified 
uniquely by some combination of punching which requires 
mu I t ipunching. A Hedge card also requires two additional items 
of information, these two extra items being User's Logical DecK 
Name and Hedge Card Name. 

User's Logical Deck Name is required since the system stages 
input to uniquely named files. It would be difficult in some 
cases to inform the user of the name of the file onto which his 
input deck has been staged, so the user is allowed to provide a 
Logical Name for his particular deck. Input Stager will keep a 
record of Logical Deck Names associated with each input device 
such that the user may access the name of the staging fi le 
associated with his Logical Deck. 

The first Hedge Card encountered in a deck will be the one 
which identifies the Logical Deck Name. Each subsequent Hedge 
Card can optionally omit the Logical Deck Name, the one first 
quoted being used. Each Hedge Card encountered In the input deck 
must have a unique name. In the event of a system crash the user 
may then quote that Hedge Card Name as the position at which he 
wishes to continue staging his input. The exact format of Hedge 
cards will be defined at a later stage. 

7.9.5.3 File Form ats . 

Two types of File are created by System Access Manager. One 
is the file from System Input Devices and the other is the mass 
storage files written by Input Stager. 

System Input Device Files. 

The general characteristics of this type of file will be. 

o File Control Block declared with a unique name in 
System Global LNS. 

o File Organization will be Sequential. 

o Usage will be Shared Read. 

o Access Method will be Sequential at the Record level. 



Mass Storage Staging File. 
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The general characteristics of this type of file will be. 

o File Control Block declared with a unique name in 
System Global LNS. 

o File will reside on System Volume Set. 

o File Organization to be Sequential. 

o Access Method will be Sequential at the Record level. 

o Usage will be Exclusive Write. 

o Error Processing will Pe left to System error handling 
procedures. 
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8.0 JOB MANA G 



y:SU£IUB£S 



This section identifies and specifies the structures which 
the facilities of Job Management utilize in the performance of 
their functions. 



8.1 JOB CON 



>0£K^JgB? 



8.1.1 STRUCTURE TYPE 

A system defined LNS record. 

8.1.2 UNIT OF ASSIGNMENT 

One JOB for each job known to the system. 

8.1.3 LOCATION OF STRUCTURE 
System Global LNS 

8.1. if RESIDENCY CHARACTERISTICS 

Pageable; not swapped with the job. 
8.1.5 STRUCTURE ASSIGNMENT 



A JOB is declared by the SUBMIT Request Processor for jobs 
submitted from within user jobs. For the syste/n's submission of 
staged batch jobs and interactive jobs, a JOB is declared by the 
STAGER program and the SYSTEM ACCESS MANAGER, respectively. 
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8.1.6 LIFECYCLE 



Once declared, the JOB exists until the job with which it is 
associated has terminated gnd until all dependency threads 
originating in it, or continuing through it, are no longer 
required by the system. 



8.1.7 CONTENTS 



o External name of the job? t 
the system to the JOB itse 
o Job status 

known but not establish 
established but not ini 
- initiated 
completed 
o Times 

first known to the syst 
estabi ished 
initiated 
completed 
o Initial priority. 
o User identifier 
o Account identifier 
o Queue-foi — establishment opt 
o Primary Input File disposit 
o Logical Sense Switches 
o Job class (batch/interact iv 
o Job type code (standard 
System Job, Diagnostic Job) 
o Primal Invocator Identifier 
o Cataloged named of the Job 
o Identifier of FOB of the jo 
o Identifier of Job's Swap Se 
o Known Job List (KJL) ordina 

job 
o Pointer to Job Gate Table i 
o Pointer to Job Stack Table 
o Origin of the Job's Estab 

thread 
o Job Resource Limit Record 
Processor time limit 
Memory limit 

Peripheral Limit Control 
— specified I imit 



his is the unique name assigned by 
if. 

ed 
tiated 



ion designator 

ion option designator 

e) 

user Job, Subsystem Supervisor Job, 

(PII) 
s Primary Input File 
b's Pool Fi le 
gment 
I of KJL entry assoc* with this 

n the job's address space 

in job's address space 

lished Program Control Block (EPCB) 



Elements (one per peripheral typel 
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number shared 

number assigned 

number claimed 
Address of the JCB of the Job which submitted this Job? for 
root Jobst this value is zero 

Address of a JCB in a forward thread of JCBs which correspond 
to other Jobs submitted by the subm^ttor of thi? ylob 
Address of a JCB in a backward thread of JCBs which correspond 
to other Jobs submitted by the submitt er of this Jo b 
Address of a JCB which constitutes the origin of a thread of 
JCBs which correspond to Jobs submitted b y this Job 



8.2 KNAM-iOB^LI^I-iK^I 



8.2.1 STRUCTURE TYPE 



KJL is comprised of a fixed number of fixed length entries. 
Every entry in KJL is a member of one of five threaded lists* (11 
those entries which are available for assignment? (2) those 
entries associated with queued jobsi (3) those entries associated 
with deferred jobs? ik) tnose entries associated with running 
jobst and (5) those entries which are in a state of transition 
between the other four threaded lists. 



8.2.2 UNIT OF ASSIGNMENT 



One entry for every Job Known to the system. Entries having 
ordinals 1 and 2 are permanently assigned to System Monitor and 
the System Job, respectively. 



8.2.3 LOCATION OF STRUCTURE 

To be determined ♦***♦*♦***♦*♦ 
8.2.^ RESIDENCY CHARACTERISTICS 

Pageable? not swapped with the associated Job 

NCR/CDC PRIVATE REV 27 MAY 75 



1 
2 
3 

5 
6 
7 
8 
9 
10 
11 
12 
13 
I'f 
15 
16 
17 
18 
19 
20 
21 
22 
23 
Zk 
25 
26 
27 
28 
29 
30 
31 
32 
33 
3^ 
35 
36 
37 
38 
39 
ifO 
41 
kZ 
kZ 
kk 
kS 
kb 
k7 
48 



8.0 JOB MANAGEMENT STRUCTURES 
3.2.5 STRUCTURE ASSIGNMENT 



8.2.5 STRUCTURE ASSIGNMENT 



A KJL entry is assigned for each Job either at the time the 
Job is established or at the time it is queued for delayed 
establishment. KJL entries are acquired for a Job by the Job 
Establisher tasK of the System Job. 



8.2.6 LIFECYCLE 



The KJL entry for a Job exists until the Job is collapsed by 
the Job Collaoser task of the System Job. 



8.2.7 CONTENTS 



Identifier of the JCB of the Job with which the KJL entry is 
associated. 
Job Status 

queued for establishment 
estabi ished 
.. swapped put 
.. swapped in 
active 
inactive 
Pointer to previous KJL entry in same thread as this entry 
Pointer to next KJL entry in same thread as this entry 
KJL thread identifier 
Swap File identifier 
Working Set Size 
Maj or Time SI i ce 

Remaining amount of major time slice 
Minor T ime SI ice 



Time selection 

Time thread 

Job identifier (<KJL ordinal> concatenated with <sequence 

number>) 

Current Job priority 

Entry Lock Indicator 

Identifier of element holding a lock 

Base Job priority 

Amount of central processor time used 

Amount of memory-time used 
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8 . 3 wiQB_STAIE_ THREAD ORIGIN TABLE (J STOT ) 



6.3.1 STRUCTURE TYPE 



JSTOT is comprised of a fixed number of fixed length 
entries. 



8.3.2 UNIT OF ASSIGNMENT 
One JSTOT in the system 

8.3.3 LOCATION OF STRUCTURES 
Same as KJL 

8. 3. if RESIDENCY CHARACTERISTICS 

Pageable 
8.3.5 STRUCTURE ASSIGNMENT 



JSTOT is constructed during system loading operation? it is 
permanently assigned to the System Job. 



8.3.6 LIFECYCLE 



Exists throughout the life of the system. 



8.3.7 CONTENTS 



o PVA of the origin of the Known Job List (KJL) 
Length of a KJL entry 
o Number of entries in KJL 
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Address of highest priority entry in KJL "available" thread 

Address of highest priority entry in KJL "neutral" thread 

Address of highest priority entry in KJL "queued" thread 

Address of highest priority entry in KJL "running" thread 

Address of highest priority entry in KJL "deferred" thread 



8.4 RUNNING JOB ORDINAL TABL E (RJO T) 



8.4.1 STRUCTURE TYPE 



RJOT is comprised of a fixed number of fixed length 
entries. 



8.4.2 UNIT OF ASSIGNMENT 



One entry for each job running in the system; one RJOT entry 
is permanently dedicated to System Monitor. 



8.4.3 LOCATION OF STRUCTURE 

Segment 5 of System Monitor address space. 

8.4.4 RESIDENCY CHARACTERISTICS 

Not pageable? swapped with the associated Job. 

8.4.5 STRUCTURE ASSIGNMENT 



An RJOT entry is assigned to a Job by System Monitor as a 
result of Job Establisher issuing a CREATE_ADDRESS_SPACE request 
during the Job estabi ishment process. 
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8. if. 6 LIFECYCLE 



An RJOT entry remains assigned to a Job during the time 
which the Job is running. The entry is released after its 
contents are transferred to the Joo's swap segment during the 
process of swapping-out the Job. An RJOT entry is assigned 
during the process of swaoping-in a Job and the previous entry 
contents are obtained from the Job's swap segment. 



8.^.7 CONTENTS 

FIeld_NaiQ2 

Job^ID 

Type 



Status 



a^scriatloD 



Job's Type, corresponds to Job Descriptor's entry 
number within KJL. 

Job Identifier. Currently the following job types 
are defined 



SDT_Ordinal 



o Standard User Job 

o Subsystem Supervisor 

o System Job 

Diagnostic Job 

o Deadstart/Recovery Job 

Job's S tatus_Indicators? these are the following: 

o RJOT Interlocked 

o Active Job 

o Going Inactive/Active 

o Ful I Swap-Out in progress 

o Full Swap-In in progress 

o No time limit 

o No swap permitted 

o No t ime si ice 

o One-Control Point-a-time dispatching 

o No forced page-steal 

o Page_Interruo t_RP in action 

o Save_Signa Is 

Relative pointer to Segment Descriptor Table of 
this job within Segment 3 of System Monitor. 
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TSL 

CTL 
PATT 

PICI 

WSSL 

CWSS 
JTL 

LPIT 
PIAS 
WSL 

SSID 
SSO 



Tab le_Size_Limit » sets maximum allowable size of 
job owned tab les within system space (modulo 256 
bytes) . 

Current_Tabl e_Size 

Page_Age_Tick_Ti me, determines tie aging_rate of 
oages belonging to a job's Working_Set. (Set by 

Job Scheduler) 

Page_Interrupt_Count_Increment ♦ Number of page 

interrupts accumulated since last examination by 
Page Contro I • 

Working_Set_Size_Limi t , if Working Set Size exceeds 
this limit, Job Scheduler is notified (in page 
size). 

Current _Work I ng_Set_Size 

Job_Time_Limit. Dispatcher compares the sum of 
Task_Execution_Times against JTL on expiration of a 
Task's time-slice, Job Scheduler is notified when 
JTL is exceeded. 

Last_Page_Interrupt_Time, sum of Task Execution 
Times is recorded here on a Page Interrupt. 

Page_Interrupt_Accumu lation_Start time in Task 
Execution Times. 

Working_Se't_LinK » relative pointer into 

Memory_Map. Used by Page Control to find the head 
of WS page chain. 

Swap Segment's unique identifier is kept here while 
a job is being deferred or made running. 

or 

Swap_Segment_Ordinal , relative Pointer into ASNT to 
find Swap Segment of a running job. 
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